home *** CD-ROM | disk | FTP | other *** search
/ Macwelt 1 / Macwelt DVD 1.toast / Web-Publishing / HTML-Editoren / Alpha ƒ / Help / FTP menu Help < prev    next >
Encoding:
Text File  |  2001-01-27  |  6.5 KB  |  192 lines
  1.  
  2. FTP Menu Help
  3.  
  4.                                                version: 0.2.1
  5.                                                created: 00-10-30 12.38.57
  6.                                            last update: 01-01-27 18.16.10
  7.  
  8. The FTP menu allows quick access to files on a remote ftp server, useful
  9. for those that work on both unix and mac systems.  Files downloaded and
  10. opened in Alpha with the help of the FTP menu are automatically uploaded
  11. again when they are saved.
  12.  
  13. The FTP menu works together with the three ftp clients Interarchy, Fetch
  14. and NetFinder, and with Alpha 8/tk can actually access ftp servers without
  15. the help of any external client.
  16.  
  17.           Activating the FTP menu
  18.  
  19. The FTP menu is activated in the dialog "Config -> Preferences -> Menus" .
  20. Check the checkbox 'Ftp Menu' among the global menus.
  21.  
  22. You must also choose either Intererchy, Fetch, or NetFinder as your ftp
  23. helper application.  Do this using "Config -> Preferences -> Helper 
  24. Applications".
  25.  
  26.           Basic usage
  27.  
  28. The first you need to do is to get a list of the files at a remote site. 
  29. This can be done by using the menu item 'Browse…'.  A dialog is now opened
  30. where you fill in the host, path (optional), user id, and password.  (Alpha
  31. doesn't support text fields in dialogs where the text is replaced by
  32. bullets.  Therefore the password box is made so small that nobody can see
  33. what you type.)
  34.  
  35. Your ftp client (Interarchy, Fetch, or NetFinder) will now get a listing of
  36. the files at the remote site.  The list is display in a list dialog.
  37.  
  38.   • Selecting a file in the dialog will download it and open it for editing 
  39.     in Alpha.  Once you save the changes, Alpha tells your ftp client to
  40.     upload the file.
  41.  
  42.   • Selecting a directory in the list (indicating by a trailing / in the 
  43.     name) will get the listing of that directory and display it in a new
  44.     list dialog.
  45.  
  46.   • Selecting '..' in the list will get a listing of the parent directory.
  47.  
  48. A menu item with your remote machine is added to the FTP menu.  Selecting
  49. this menu item will the display the file list again.  This to allow you to
  50. quickly download another file from the same place.
  51.  
  52.           Startup problem with Fetch
  53.  
  54. If Alpha launches Fetch from the FTP menu, Fetch occasionaly get stuck 
  55. after displaying its sign-on dialog. If this happens you have to switch to 
  56. Fetch and dismiss this dialog before Fetch continues working. To avoid this 
  57. problem completely uncheck "Show sign-on dialog at startup" in Fetch's Misc 
  58. preference dialog.
  59.  
  60.           Cache
  61.  
  62. Alpha saves the directory listing in a cache to be able to quickly display
  63. them again without having to download them every time.  Whenever new files
  64. are added to the remote site the cache becomes out of date.  You can clear
  65. the cache by selecting 'Flush Cache' from the FTP menu.  The cache is also
  66. flushed when you quit Alpha.  This forces the directory listing to be
  67. downloaded again.  If you don't want to use a cache at all, uncheck 'Use
  68. Cache' in the FTP menu.
  69.  
  70.           Mount points
  71.  
  72. The point where you start browsing a remote site is called a mount point. 
  73. There are two types of mount points: temporary and permanent.
  74.  
  75.   • Temporary mount points are mount points which only exist during the 
  76.     current session with Alpha.  Whenever you use 'Browse…' to browse a new
  77.     site a temporary mount point is created.  All temporary mount points
  78.     are listed at the bottom of the FTP menu for quick access.
  79.  
  80.   • Permanent mount points are mount points, which are saved between 
  81.     sessions with Alpha.  You create a new permanent mount point by using
  82.     'Add Mount Point…' in the FTP menu.  You can later remove it using
  83.     'Remove Mount Point…'.  The permanent mount points are listed in the
  84.     FTP menu just above the temporary ones.
  85.  
  86. A temporary mount point can be made permanent by using 'Make Permanent…'.
  87.  
  88.           Titlebar click
  89.  
  90. Clicking on the title on a window downloaded from a remote site, displays a
  91. popup menu with the path for the file at the remote site.  Selecting a
  92. directory in this popup menu opens a directory listing dialog with all
  93. files allowing you to download another file.  This gives you quick access
  94. to the remote files.
  95.  
  96.           Ftp filesets
  97.  
  98. An ftp fileset in a set of files in a remote directory, which will be put
  99. in a submenu in the Fileset menu.  Selecting a file in the Fileset menu
  100. will download and open it for editing in Alpha.
  101.  
  102. You create a new ftp fileset by using 'Create Fileset' in the FTP menu or
  103. by using 'New Fileset…' in the Fileset menu and choosing the type 'ftp'.
  104.  
  105.   • First you specify a name for the fileset, which will be the name of the 
  106.     submenu in the Fileset menu, and information about the host, userid etc.
  107.  
  108.   • Then you are asked to specify a pattern which determines which files to 
  109.     include in the fileset, e.g. you may only wish to include all .html
  110.     files.  This pattern must be entered as a regular expression.  Some
  111.     examples how to specify the pattern:
  112.  
  113.     .*          all files
  114.     .*\.html    all .html files
  115.     .*\.[ch]    all .c files and all .h files
  116.  
  117.   • You are finally asked if you want to save the fileset. Doing so will 
  118.     keep it available next time you run Alpha.
  119.     
  120. Now the listing of the files in the fileset is downloaded and the fileset
  121. is inserted in the menu.
  122.  
  123.           Passwords and Security
  124.  
  125. All passwords which are saved between sessions are saved as plain text in
  126. Alpha's preferences folder.  Thus, only give your password when defining
  127. permanent mount points or filesets if nobody else have access to your
  128. computer.
  129.  
  130.  
  131.           Ftp menu items
  132.  
  133.  
  134. This section list all menu items in the FTP menu giving a short description
  135. of their functionality.
  136.  
  137.     Help                    
  138.  
  139. Opens this file.
  140.  
  141.     Browse…                     
  142.  
  143. Browse a remote site.
  144.  
  145.     Browse Current… (option)    
  146.  
  147. Browse the mount point of the frontmost window.
  148.  
  149.     Browse Mounts…              
  150.  
  151. Lets you pick a mount point to browse from a list of all your mount points
  152. both temporary and permanent.
  153.  
  154.     Add Mount Point…            
  155.  
  156. Add a new permanent mount point
  157.  
  158.     Make Permanent…             
  159.  
  160. Make a temporary mount point permanent.
  161.  
  162.     Remove Mount Point…         
  163.  
  164. Remove a permanent mount point.
  165.  
  166.     Save As At…                 
  167.  
  168. Lets you 'Save as' the frontmost window at any of your mount points.
  169.  
  170.  
  171.     Set Defaults
  172.  
  173. Lets you set default ftp mount point values, including host, directory,
  174. username, and password.  Any or all of these values can be set, and will be
  175. used in all "login" dialogs.
  176.  
  177.     Use Cache                   
  178.  
  179. If checked all directory listings are stored in a cache.
  180.  
  181.     Flush cache                 
  182.  
  183. Deletes all files in the cache.  The cache is also flushed when you quit
  184. Alpha.
  185.  
  186.     Create Fileset              
  187.  
  188. Create an ftp fileset.
  189.  
  190.  
  191.  
  192.